home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Languguage OS 2
/
Languguage OS II Version 10-94 (Knowledge Media)(1994).ISO
/
language
/
parallax
/
sparc_so.tar
/
sun4sol
/
README.pz2c
< prev
Wrap
Text File
|
1993-12-06
|
5KB
|
123 lines
This file decribes how to install the PARZ-Compiler pz2c and how to use it.
The "PARZ to C"-compiler is available for the following systems:
- SUN-3 (running SunOS Release 4.0 or higher)
- SUN-3 (w/o numeric co-processor)
- SUN-4 (running SunOS Release 4.0 or higher)
- IBM RS-6000 or compatibles
- HP /700 series
- HP /800 series
- HP 9000/300 (running HP-UX 7.00 or higher)
- DECStation 2100 or compatibles (running Ultrix V 2.1 or higher)
- VAXStation 3520 or compatibles (running Ultrix V 4.0 or higher)
- VAX / VMS
First of all you have to receive your copy of the PARZ-compiler software package
as decribed in the "Parallaxis Version 2 User Manual".
Installation
============
1) uncompress and de-archive the archive file.
2) copy the executable file 'pz2c' to the local '/usr/local/bin' directory
3) copy the manual page 'pz2c.l' to the local '/usr/share/man/manl' directory
4) copy the header file 'pz2c.h' to the local '/usr/include' directory
5) copy the library file 'libpz2c.a' to the local '/usr/local/lib' directory
6) run the program "ranlib" on the library file
Usage
=====
The compiler is started by typing
pz2c {options} inFilename [-o exeFilename]
Compiling PARZ programs into C programs gives two advantages:
* compiled Parallaxis/PARZ programs are faster than interpreted ones
* compiled Parallaxis/PARZ programs are easily portable,
since almost every computer system comes with a C compiler.
Options start with a '-' sign. All characters after the '-' sign up to the
next white space are treated as options. A compiler call may contain more
than one option.
The options for both compilers are:
enum set the maximum number of reported error messages
m call the C/MPL compiler for existing code
O invoke the optimizer (capital O) of the C/MPL compiler
p first run the Parallaxis compiler
r remove generated C/MPL source code after compiling it
t generate trace information for all PARZ labels
(only for debugging)
v verbose mode, give information about the compiling
wnum set the maximum number of reported warnings
x create an identifier cross-reference file.
This file will have the extension .ref
z don't call the C/MPL compiler after generating the C/MPL
source code
The compiler takes files ending with .z as input files. If the filename entered
does not have this extension, the compiler adds .z and tries to open this file.
If option -p is provided or the inFilename has the extension .p, the Parallaxis
compiler is invoked with the options -dmnrx, i.e. DEBUG and TRACE commands are
ignored, no PARZ code for operand-checking in mathematical operations,
range-check, or NIL-pointer de-referentiation is generated.
The name of the generated C program is built by removing the standard extension
from the inFilename and adding the extension .c to it. The name of the
generated executable file is normally built by removing the standard extension
from the inFilename. If option -o exeFilename is provided, this filename is
used for the executable program.
Note, that no DEBUG or TRACE information is supported, i.e. DEBUG and TRACE
statements in the input file are skipped and a warning is reported.
To create a stand-alone executable file, two files are required:
* pz2c.h the C include file
* libpz2c.a the linking library on UNIX systems
If you cannot copy these files in the standard search paths for include files
and libraries, set the environment variables PZ2C_HEADER and PZ2C_LIB to the
directories, which contain these files. E.g., if the file libpz2c.a resides in
the directory /home/smith/lib, the variable PZ2C_LIB must have the value
'/home/smith/lib'.
In modification to the manual, measured run times will be printed in
a file instead of standard output. The name of this file is built by
removing the extension from the in_filename and adding the extension
'.timing' to it. Each entry in the timing file contains two numbers.
The first is the result of the 'ftime()' system call, the second
is determined by the 'gettimeofday' library routine.
New Features (Version 2.0.5)
============================
* Using the option '-d', you can force the use of double-precision
for floating-point variables. The advantage is the higher accuracy,
the disadvantage is that floating point computations become slower and
each (!) variable requires the size of a 'double' on the machine,
typically 8 bytes instead of 4 bytes.
Therefore two libraries exist, one for single-precision (libpz2cs.a) and
another for double-precision (libpz2cd.a).
* The system software was ported to VAX systems running VMS.
The graphics functions cannot be used under DECwindows.
Bugs
====
Please send bug reports
To: engelhar@informatik.uni-stuttgart.de
Cc: braunl@informatik.uni-stuttgart.de